******************************************************************************   
** SmartRENES                                                               **
** Author: Hyde                                                             **
** E-Mail: _hyde_@programmer.net                                            **
** Website: http://hydesprojects.cjb.net/                                   ** 
******************************************************************************

==============================================================================
What's New?
==============================================================================

11/28/04

 - Removed unnecessary output of .export statements from mapper #0, 3, 7
   handlers;
 - Began work on SPC-7000 support (not enabled yet);
 - Modified the "Usage" and "Acknowledgements" sections of this document;
 - Added "To-Do" and "Final Words" sections to this document;

11/22/04

 - First release. 
   Note: Disassemblies are placed in the folder holding the game to be
   disassembled.

==============================================================================
Introduction
==============================================================================

This is yet another interactive disassembler that will help you RE games
quickly. I chose to develop this program because of the lack of disassemblers
that output readable and recompilable code. 

==============================================================================
Capabilities
==============================================================================

The disassembler can read in the following types of code:

- NES code (iNES format supported);
  Mappers: 0, 1, 2, 3, 7

To be added:

- Support for SPC-7000 files (SPC format);

Other kinds of files may be supported in the future, but I make no guarantees.

==============================================================================
Requirements
==============================================================================

You must have the Microsoft .NET Framework installed on your computer because
this application was coded in C#.

I have managed to disassemble Battletoads (U) (about 1.25 MB worth of code)
in several seconds. Here are my computer's specifications:

eTower 500 Mhz Celeron 192 MB RAM 

==============================================================================
Usage
==============================================================================

- Run the program;
- Click on the "Load Cartridge..." button;
- Select the iNES image to be disassembled;
- Click on the "Load Labels..." button;
- Select the file holding label descriptions;
- Click on the disassemble button;
- Disassemblies should appear in the folder holding the game you just
  disassembled.

You will need CA65 in order to assemble the output properly. The reason for this
is that other assemblers are unable to handle statements such as

	lda $0000; 

correctly. Most of them will translate this line of code to

	lda $00;

One of the bytes ($00) disappears, thus causing the resulting image to
malfunction. 

==============================================================================
Issues
==============================================================================

One thing you should be aware of is that this program is not perfect. So, you
will most likely encounter some issues as you RE games. Let me know about them.

==============================================================================
To-Do
==============================================================================

- Allow the user to specify an output directory;
- Add some sort of a progress bar that indicates how the disassembly process 
  is going;

==============================================================================
Acknowledgements
==============================================================================

Memblers, Tepples, Bananmos, WhoaMan, Bbitmaster, Dan, Gavin, and all others
who have given me some sort of feedback (mostly everyone from #rom-hacking).

==============================================================================
Final Words
==============================================================================

Feel free to submit disassemblies to my mailbox; I will gladly upload them to
my site. Make sure you give yourself credit for your work by creating a
"Readme.txt" file similar to the one I put in every one of my disassemblies.
I will also give you credit for it. Bah, who needs credits anyways?  